home *** CD-ROM | disk | FTP | other *** search
/ MacFormat España 15 / macformat_15.iso / Shareware Internet / Ciencia / john's calculator 0.1b / readme (john's calculator) < prev   
Text File  |  1996-02-27  |  8KB  |  231 lines

  1. john's calculator
  2. written by John Wilhelm using Mops 2.7
  3. version 0.1b (beta)
  4. copyright © 1996, John Wilhelm
  5.  
  6. Contact Information:
  7. wilhelm@gate.net
  8. wilehlmj@email.spjc.cc.fl.us
  9.  
  10. Description:
  11. john's calculator is a simple, powerful, and fast keyboard-based calculator. Expressions are entered as by hand, using either the keyboard or calculator buttons. Standard editing commands like cut, copy, and paste are fully supported. Variables can be used to simplify expressions.
  12.  
  13. This is a beta version of john's calculator. If you find bugs or have suggestions please contact me at one of the addresses given above.
  14.  
  15. Installation:
  16. Copy the file "john's calculator" to where you want it. That's it.
  17.  
  18. How to use john's calculator:
  19. Enter an expression on a line by itself. Then press the ENTER key to evaluate the line, regardless of where the cursor is in the line.
  20. Note that you must press the ENTER key to evaluate an expression - the RETURN key inserts a carriage return but does not evaluate.
  21.  
  22. You can return to a previous line, edited it, press the ENTER key and the changed line will be evaluated.
  23.  
  24. Some examples:
  25.  
  26. 2(2+3)                         enter 2(2+3) then press the ENTER key
  27.  10                              the line is evaluated and the value returned on the next line
  28.  
  29. 2e2^2                          this is the same as 200^2 (2e2 is 2x10^2)
  30.  40000
  31.  
  32. 5log(2^5)                    this is the same as 5(log(2^5))
  33.  7.52575 
  34.  
  35. 5log2^5                       this is the same as 2((log2)^5)
  36.  0.01236
  37.  
  38. 10->x                          store 10 in the variable named x
  39.  10
  40. 20->y                          store 20 in the variable named y
  41.  20
  42. 2x+3y                          this is the same as 2(10)+3(20)
  43.  80
  44.  
  45. -1-9->x                      now store -1-9 in x
  46.  -10
  47. 2x+3y                         now this is the same as 2(-10)+3(20)
  48.  40
  49.  
  50. :5->x                           store 5 in x, ":" stops the value from being returned
  51. :2->y                           store 2 in y
  52. x^2+y^2                        this is the same as 5^2+2^2
  53.  29
  54.  
  55. Now we could return to the line ":5->x", change the 5 to a 0 and press the ENTER key. This would change the value of x to 0.
  56. If we then return to the line "x^2+y^2" and press the ENTER key, 4 is returned (0^2+2^2).
  57.  
  58. 1+2
  59.  3
  60. ans                                                            enter ans then press the ENTER key
  61.  3                                the last answer, 3, is returned
  62. 1+ans                          this is the same as 1+3 since 3 was the last answer
  63.  4
  64.  
  65. 5-2
  66.  3
  67. +2                                this is the same as 3+2 since the previous answer is used when not
  68.  5                                 enough arguments are given on a line
  69. ^3                                 this is the same as 5^3
  70.  125
  71.  
  72. 60!
  73.  ?                                 60! is too big to display in decimal mode
  74. 60!                               use radio button to change display mode to scientific display
  75.  8.32099e+81               no problem (though precision is lost)
  76.  
  77. Most operations which take two arguments can be enter as opn(arg1,arg2) or arg1opnarg2.  Usually one of the two forms is much clearer.
  78. examples:  
  79. gcd(10,2) and 10gcd2 both return 2 (the greatest common divisor)
  80. 10^2 and ^(10,2) both return 100
  81.  
  82. There is a complete list of operations below.
  83.  
  84. Buttons:
  85. Input buttons:
  86. All operations are available on calculator input buttons.
  87.  
  88. Radio buttons:
  89. (1)   Mode group - sets mode to radians or degrees
  90. (2)   Display group - sets calculator to display answer in decimal or scientific notation form
  91. (3)   Level group - sets which level of input buttons is shown
  92.  
  93. Enter button:
  94. Same as pressing the ENTER key.
  95.  
  96. Menus:
  97. The "File" and "Edit" menus work in the usual fashion.
  98.  
  99. Variables menu:
  100. Show - shows all variables and values
  101. Clear All - clears all variables (so no variables are stored)
  102. The variable menu is not available unless a variable is defined.
  103.  
  104. Evaluation Errors:
  105. If john's calculator can't understand an operation it will highlight the first thing it doesn't understand (and beep at you).
  106.  
  107. If there are not enough arguments for the operations  in an expression an alert box will pop
  108. up and say so.
  109.  
  110. Gotchas:
  111. (1)  You must use the ENTER key, not the RETURN key, to evaluate a line.
  112.  
  113. (2)   Rules about variable names.
  114.         (a)  Variable names are not case sensitive. So "x" and "X" are the same variable names.
  115.         (b)  Variable names can contain spaces except at the beginning. So "x1" and "x1   " are
  116.         different variables. But "2->    x" would store 2 in the variable named "x".
  117.         (c)  Variable names can be any length. So "my variable" is a valid variable name.
  118.         (d)  Just about any character is valid in variable name. So "#$-" is ok.
  119.  
  120. (3)  When evaluating a line john's calculator checks for variable names before anything else.
  121. You can use a variable named "log" if you want but this carries obvious risks.
  122.  
  123. (4)   Up to 100 variables can be stored. You can clear all variables using the "Clear All" 
  124.  command of the "Variables" menu or clear individual variables using the "<-" operator.
  125.  
  126. (5)   The calculator only ask if you want to save changes if you are working with a named
  127. file.
  128.  
  129. (6)    ":" must be the first non-blank character on a line.
  130.  
  131. (7)   In decimal display mode answers are rounded after 19 digits.
  132.  
  133. Operations:
  134. Here is a listing of the operations john's calculator understands.
  135.  
  136. +          addition
  137. -          subtraction
  138. *          multiplication
  139. /          division
  140. ^           exponentiation
  141.  
  142. ln         natural logarithm
  143. log       logarithm base 10
  144. lognx   logarithm base n of x
  145.            lognx(2,16)   returns 4
  146. ()         parentheses
  147. ,           separates arguments
  148.  
  149. sin       sine
  150. cos       cosine
  151. tan       tangent
  152. cot       cotangent
  153. ans       last answer returned
  154.  
  155.  
  156. sqrt      square root
  157. %          percent
  158.             5%20   returns 25 (since 5 is 25% of 20)
  159. 1/x       reciprocal
  160. //         modulus (remainder)
  161.             16//7    returns 2 (since the remainder for 16/7 is 2)
  162. ^(1/)     arbitrary root
  163.             16^(1/4)    returns 2 (since the principle 4th root of 16 is 2)
  164.  
  165. e^         natural base e raised to an exponent
  166. :           don't return value (must be at start of line)
  167. ->         store value in variable
  168. <-         clear variable name
  169.             <-x    returns value in x and clears x from storage
  170. r2d       change radians to degrees
  171.  
  172. arcSin  arcSine
  173. arcCos  arcCosine
  174. arcTan  arcTangent
  175. arcCot  arcCotangent
  176. d2r       change degrees to radians
  177.  
  178.  
  179. mPn      permutations of n things taken from m things
  180.              mPn(10,2) or 10mPn2   returns 90
  181. mCn      combinations of n things taken from m things
  182.              mCn(10,2) or 10mCn2   returns 45
  183. !            factorial
  184. gcd       greatest common divisor
  185.                         gcd(200,60)   returns 20
  186. lcm       least common multiple
  187.  
  188. pi           π
  189. e             the natural base e
  190. round      round to integer
  191.                             round(2.514)   returns 3
  192. trunc      truncates to integer
  193.                             trunc(2.514)   returns 2
  194. abs         absolute value
  195.  
  196. csc         coSecant
  197. sec         secant
  198. sinh        hyperbolic sine
  199. cosh       hyperbolic cosine
  200. tanh        hyperbolic tangent
  201.  
  202. Known bugs:
  203. None (oh boy).
  204.  
  205. Version History:
  206. 0.0b - first beta release (22 Jan 1996)
  207. 0.1b - 2nd beta release (24 Feb 1996)
  208.     fixed some problems with file handling
  209.     cleaned-up resizing
  210.     cleaned/fixed some internals 
  211.  
  212. Standard Stuff:
  213. Although copyrighted, john's calculator is freeware and may be distributed freely as long as this file is included. However, ownership of and interest in this software shall remain with John Wilhelm.
  214.  
  215. This software is provided “as is” without warranty of any kind.  The entire risk as to the results of using this software lies entirely with the user.
  216.  
  217. In no event shall the author be liable for any damages arising out of the use or inability to use this software. 
  218.  
  219.  
  220.                       
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.